home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cato / Xm / XmCommand.z / XmCommand
Encoding:
Text File  |  2002-10-03  |  31.8 KB  |  463 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmCCCCoooommmmmmmmaaaannnndddd((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmCCCCoooommmmmmmmaaaannnndddd((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmCCCCoooommmmmmmmaaaannnndddd - The Command widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////CCCCoooommmmmmmmaaaannnndddd....hhhh>>>>
  13.  
  14.  
  15.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  16.           This page documents version 1.2 of the Motif library.
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           Command is a special-purpose composite widget for command
  20.           entry that provides a built-in command-history mechanism.
  21.           Command includes a command-line text-input field, a
  22.           command-line prompt, and a command-history list region.
  23.  
  24.           One additional WWWWoooorrrrkkkkAAAArrrreeeeaaaa child may be added to the Command
  25.           after creation.
  26.  
  27.           Whenever a command is entered, it is automatically added to
  28.           the end of the command-history list and made visible.  This
  29.           does not change the selected item in the list, if there is
  30.           one.
  31.  
  32.           Many of the new resources specified for Command are actually
  33.           SelectionBox resources that have been renamed for clarity
  34.           and ease of use.
  35.  
  36.         CCCCllllaaaasssssssseeeessss
  37.           Command inherits behavior and resources from CCCCoooorrrreeee,
  38.           CCCCoooommmmppppoooossssiiiitttteeee, CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr, XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd, and
  39.           XXXXmmmmSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx classes.
  40.  
  41.           The class pointer is xxxxmmmmCCCCoooommmmmmmmaaaannnnddddWWWWiiiiddddggggeeeettttCCCCllllaaaassssssss.
  42.  
  43.           The class name is XXXXmmmmCCCCoooommmmmmmmaaaannnndddd.
  44.  
  45.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  46.           The following table defines a set of widget resources used
  47.           by the programmer to specify data.  The programmer can also
  48.           set the resource values for the inherited classes to set
  49.           attributes for this widget.  To reference a resource by name
  50.           or by class in a .Xdefaults file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  51.           prefix and use the remaining letters.  To specify one of the
  52.           defined values for a resource in a .Xdefaults file, remove
  53.           the XXXXmmmm prefix and use the remaining letters (in either
  54.           lowercase or uppercase, but include any underscores between
  55.           words).  The codes in the access column indicate if the
  56.           given resource can be set at creation time (C), set by using
  57.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  58.           not applicable (N/A).
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmCCCCoooommmmmmmmaaaannnndddd((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmCCCCoooommmmmmmmaaaannnndddd((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                                     XXXXmmmmCCCCoooommmmmmmmaaaannnndddd RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  75.      NNNNaaaammmmeeee                         CCCCllllaaaassssssss                 TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  76.      ____________________________________________________________________________________
  77.      XmNcommand                   XmCTextString         XmString         ""        CSG
  78.      XmNcommandChangedCallback    XmCCallback           XtCallbackList   NULL      C
  79.      XmNcommandEnteredCallback    XmCCallback           XtCallbackList   NULL      C
  80.      XmNhistoryItems              XmCItems              XmStringTable    NULL      CSG
  81.      XmNhistoryItemCount          XmCItemCount          int              0         CSG
  82.      XmNhistoryMaxItems           XmCMaxItems           int              100       CSG
  83.      XmNhistoryVisibleItemCount   XmCVisibleItemCount   int              dynamic   CSG
  84.      XmNpromptString              XmCPromptString       XmString         dynamic   CSG
  85.  
  86.  
  87.           XXXXmmmmNNNNccccoooommmmmmmmaaaannnndddd
  88.                     Contains the current command-line text.  This is
  89.                     the XXXXmmmmNNNNtttteeeexxxxttttSSSSttttrrrriiiinnnngggg resource in SelectionBox,
  90.                     renamed for Command.  This resource can also be
  91.                     modified via XXXXmmmmCCCCoooommmmmmmmaaaannnnddddSSSSeeeettttVVVVaaaalllluuuueeee and
  92.                     XXXXmmmmCCCCoooommmmmmmmaaaannnnddddAAAAppppppppeeeennnnddddVVVVaaaalllluuuueeee functions.  The command area
  93.                     is a Text widget.
  94.  
  95.           XXXXmmmmNNNNccccoooommmmmmmmaaaannnnddddCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
  96.                     Specifies the list of callbacks that is called
  97.                     when the value of the command changes.  The
  98.                     callback reason is XXXXmmmmCCCCRRRR____CCCCOOOOMMMMMMMMAAAANNNNDDDD____CCCCHHHHAAAANNNNGGGGEEEEDDDD.  This is
  99.                     equivalent to the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk of the
  100.                     Text widget, except that a pointer to an
  101.                     XXXXmmmmCCCCoooommmmmmmmaaaannnnddddCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttuuuurrrreeee is passed, and the
  102.                     structure's _v_a_l_u_e member contains the XXXXmmmmSSSSttttrrrriiiinnnngggg.
  103.  
  104.           XXXXmmmmNNNNccccoooommmmmmmmaaaannnnddddEEEEnnnntttteeeerrrreeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
  105.                     Specifies the list of callbacks that is called
  106.                     when a command is entered in the Command.  The
  107.                     callback reason is XXXXmmmmCCCCRRRR____CCCCOOOOMMMMMMMMAAAANNNNDDDD____EEEENNNNTTTTEEEERRRREEEEDDDD.  A
  108.                     pointer to an XXXXmmmmCCCCoooommmmmmmmaaaannnnddddCCCCaaaallllllllbbbbaaaacccckkkk structure is
  109.                     passed.
  110.  
  111.           XXXXmmmmNNNNhhhhiiiissssttttoooorrrryyyyIIIItttteeeemmmmssss
  112.                     Lists XXXXmmmmSSSSttttrrrriiiinnnngggg items that make up the contents of
  113.                     the history list.  This is the XXXXmmmmNNNNlllliiiissssttttIIIItttteeeemmmmssss
  114.                     resource in SelectionBox, renamed for Command.
  115.                     XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss for this resource returns the list
  116.                     items themselves, not a copy of the list items.
  117.                     The application must not free the returned items.
  118.  
  119.           XXXXmmmmNNNNhhhhiiiissssttttoooorrrryyyyIIIItttteeeemmmmCCCCoooouuuunnnntttt
  120.                     Specifies the number of XXXXmmmmSSSSttttrrrriiiinnnnggggssss in
  121.                     XXXXmmmmNNNNhhhhiiiissssttttoooorrrryyyyIIIItttteeeemmmmssss.  This is the XXXXmmmmNNNNlllliiiissssttttIIIItttteeeemmmmCCCCoooouuuunnnntttt
  122.                     resource in SelectionBox, renamed for Command.
  123.                     The value must not be negative.
  124.  
  125.           XXXXmmmmNNNNhhhhiiiissssttttoooorrrryyyyMMMMaaaaxxxxIIIItttteeeemmmmssss
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmCCCCoooommmmmmmmaaaannnndddd((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmCCCCoooommmmmmmmaaaannnndddd((((3333XXXX))))
  137.  
  138.  
  139.  
  140.                     Specifies the maximum number of items allowed in
  141.                     the history list.  Once this number is reached, an
  142.                     existing list item must be removed before a new
  143.                     item can be added to the list.  For each command
  144.                     entered, the first list item is removed from the
  145.                     list, so the new command can be added to the list.
  146.                     The value must be greater than 0.
  147.  
  148.           XXXXmmmmNNNNhhhhiiiissssttttoooorrrryyyyVVVViiiissssiiiibbbblllleeeeIIIItttteeeemmmmCCCCoooouuuunnnntttt
  149.                     Specifies the number of items in the history list
  150.                     that should be visible at one time.  In effect, it
  151.                     sets the height (in lines) of the history list
  152.                     window.  This is the XXXXmmmmNNNNlllliiiissssttttVVVViiiissssiiiibbbblllleeeeIIIItttteeeemmmmCCCCoooouuuunnnntttt
  153.                     resource in SelectionBox, renamed for Command.
  154.                     The value must be greater than 0.  The default is
  155.                     dynamic based on the height of the list.
  156.  
  157.           XXXXmmmmNNNNpppprrrroooommmmppppttttSSSSttttrrrriiiinnnngggg
  158.                     Specifies a prompt for the command line.  This is
  159.                     the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg resource in
  160.                     SelectionBox, renamed for Command.  The default
  161.                     may vary depending on the value of the
  162.                     XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn resource and the locale.  In
  163.                     the C locale the default is ">".
  164.  
  165.  
  166.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  167.           Command inherits behavior and resources from the following
  168.           superclasses.  For a complete description of each resource,
  169.           refer to the man page for that superclass.
  170.  
  171.                                           XXXXmmmmSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  172.      NNNNaaaammmmeeee                      CCCCllllaaaassssssss                     TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                   AAAAcccccccceeeessssssss
  173.      _____________________________________________________________________________________________________
  174.      XmNapplyCallback          XmCCallback               XtCallbackList   NULL                      N/A
  175.      XmNapplyLabelString       XmCApplyLabelString       XmString         dynamic                   N/A
  176.      XmNcancelCallback         XmCCallback               XtCallbackList   NULL                      N/A
  177.      XmNcancelLabelString      XmCCancelLabelString      XmString         dynamic                   N/A
  178.      XmNchildPlacement         XmCChildPlacement         unsigned char    XmPLACE_ABOVE_SELECTION   CSG
  179.      XmNdialogType             XmCDialogType             unsigned char    XmDIALOG_COMMAND          G
  180.      XmNhelpLabelString        XmCHelpLabelString        XmString         dynamic                   N/A
  181.      XmNlistItemCount          XmCItemCount              int              0                         CSG
  182.      XmNlistItems              XmCItems                  XmStringTable    NULL                      CSG
  183.      XmNlistLabelString        XmCListLabelString        XmString         NULL                      N/A
  184.      XmNlistVisibleItemCount   XmCVisibleItemCount       int              dynamic                   CSG
  185.      XmNminimizeButtons        XmCMinimizeButtons        Boolean          False                     N/A
  186.      XmNmustMatch              XmCMustMatch              Boolean          False                     N/A
  187.      XmNnoMatchCallback        XmCCallback               XtCallbackList   NULL                      N/A
  188.      XmNokCallback             XmCCallback               XtCallbackList   NULL                      N/A
  189.      XmNokLabelString          XmCOkLabelString          XmString         dynamic                   N/A
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmCCCCoooommmmmmmmaaaannnndddd((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmCCCCoooommmmmmmmaaaannnndddd((((3333XXXX))))
  203.  
  204.  
  205.  
  206.      XmNselectionLabelString   XmCSelectionLabelString   XmString         dynamic                   CSG
  207.      XmNtextAccelerators       XmCTextAccelerators       XtAccelerators   default                   C
  208.      XmNtextColumns            XmCColumns                short            dynamic                   CSG
  209.      XmNtextString             XmCTextString             XmString         ""                        CSG
  210.  
  211.                                 XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  212.      NNNNaaaammmmeeee                  CCCCllllaaaassssssss                TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt         AAAAcccccccceeeessssssss
  213.      __________________________________________________________________________________
  214.      XmNallowOverlap       XmCAllowOverlap      Boolean          True            CSG
  215.      XmNautoUnmanage       XmCAutoUnmanage      Boolean          False           N/A
  216.      XmNbuttonFontList     XmCButtonFontList    XmFontList       dynamic         N/A
  217.      XmNcancelButton       XmCWidget            Widget           NULL            N/A
  218.      XmNdefaultButton      XmCWidget            Widget           NULL            N/A
  219.      XmNdefaultPosition    XmCDefaultPosition   Boolean          False           CSG
  220.      XmNdialogStyle        XmCDialogStyle       unsigned char    dynamic         CSG
  221.      XmNdialogTitle        XmCDialogTitle       XmString         NULL            CSG
  222.      XmNfocusCallback      XmCCallback          XtCallbackList   NULL            C
  223.      XmNlabelFontList      XmCLabelFontList     XmFontList       dynamic         CSG
  224.      XmNmapCallback        XmCCallback          XtCallbackList   NULL            C
  225.      XmNmarginHeight       XmCMarginHeight      Dimension        10              CSG
  226.      XmNmarginWidth        XmCMarginWidth       Dimension        10              CSG
  227.      XmNnoResize           XmCNoResize          Boolean          False           CSG
  228.      XmNresizePolicy       XmCResizePolicy      unsigned char    XmRESIZE_NONE   CSG
  229.      XmNshadowType         XmCShadowType        unsigned char    XmSHADOW_OUT    CSG
  230.      XmNtextFontList       XmCTextFontList      XmFontList       dynamic         CSG
  231.      XmNtextTranslations   XmCTranslations      XtTranslations   NULL            C
  232.      XmNunmapCallback      XmCCallback          XtCallbackList   NULL            C
  233.  
  234.                                           XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  235.      NNNNaaaammmmeeee                    CCCCllllaaaassssssss                   TTTTyyyyppppeeee                DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  236.      _________________________________________________________________________________________________
  237.      XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
  238.      XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
  239.      XmNforeground           XmCForeground           Pixel               dynamic                CSG
  240.      XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C
  241.      XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
  242.      XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG
  243.      XmNinitialFocus         XmCInitialFocus         Widget              dynamic                CSG
  244.      XmNnavigationType       XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
  245.      XmNshadowThickness      XmCShadowThickness      Dimension           dynamic                CSG
  246.      XmNstringDirection      XmCStringDirection      XmStringDirection   dynamic                CG
  247.      XmNtopShadowColor       XmCTopShadowColor       Pixel               dynamic                CSG
  248.      XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
  249.      XmNtraversalOn          XmCTraversalOn          Boolean             True                   CSG
  250.      XmNunitType             XmCUnitType             unsigned char       dynamic                CSG
  251.      XmNuserData             XmCUserData             XtPointer           NULL                   CSG
  252.  
  253.                              CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  254.      NNNNaaaammmmeeee                CCCCllllaaaassssssss               TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  255.      ______________________________________________________________________
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmCCCCoooommmmmmmmaaaannnndddd((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmCCCCoooommmmmmmmaaaannnndddd((((3333XXXX))))
  269.  
  270.  
  271.  
  272.      XmNchildren         XmCReadOnly         WidgetList    NULL      G
  273.      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
  274.      XmNnumChildren      XmCReadOnly         Cardinal      0         G
  275.  
  276.                                                    CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  277.      NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  278.      ______________________________________________________________________________________________________________
  279.      XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                N/A
  280.      XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  281.      XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  282.      XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  283.      XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  284.      XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  285.      XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  286.      XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  287.      XmNdepth                        XmCDepth                        int              dynamic                CG
  288.      XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  289.      XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  290.      XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  291.      XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  292.      XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  293.      XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  294.      XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  295.      XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  296.      XmNx                            XmCPosition                     Position         0                      CSG
  297.      XmNy                            XmCPosition                     Position         0                      CSG
  298.  
  299.         CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  300.           A pointer to the following structure is passed to each
  301.           callback:
  302.  
  303.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  304.           {{{{
  305.             iiiinnnntttt      _r_e_a_s_o_n;;;;
  306.             XXXXEEEEvvvveeeennnntttt   * _e_v_e_n_t;;;;
  307.             XXXXmmmmSSSSttttrrrriiiinnnngggg _v_a_l_u_e;;;;
  308.             iiiinnnntttt      _l_e_n_g_t_h;;;;
  309.           }}}} XXXXmmmmCCCCoooommmmmmmmaaaannnnddddCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt;;;;
  310.  
  311.  
  312.           _r_e_a_s_o_n Indicates why the callback was invoked
  313.  
  314.           _e_v_e_n_t  Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback
  315.  
  316.           _v_a_l_u_e  Specifies the XXXXmmmmSSSSttttrrrriiiinnnngggg in the CommandArea
  317.  
  318.           _l_e_n_g_t_h Specifies the size of the command in XXXXmmmmSSSSttttrrrriiiinnnngggg
  319.  
  320.  
  321.         TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  322.           XmCommand inherits translations from XmSelectionBox.
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 4/30/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmCCCCoooommmmmmmmaaaannnndddd((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmCCCCoooommmmmmmmaaaannnndddd((((3333XXXX))))
  335.  
  336.  
  337.  
  338.         AAAAcccccccceeeelllleeeerrrraaaattttoooorrrrssss
  339.           The XXXXmmmmNNNNtttteeeexxxxttttAAAAcccccccceeeelllleeeerrrraaaattttoooorrrrssss from XmSelectionBox are added to the
  340.           Text descendant of XmCommand.
  341.  
  342.         AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss
  343.           The XmCommand action routines are described below:
  344.  
  345.  
  346.           SSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxxUUUUppppOOOOrrrrDDDDoooowwwwnnnn((((0000||||1111||||2222||||3333)))):
  347.                     When called with a 0 argument, selects the
  348.                     previous item in the history list and replaces the
  349.                     text with that item.
  350.  
  351.                     When called with a 1 argument, selects the next
  352.                     item in the history list and replaces the text
  353.                     with that item.
  354.  
  355.                     When called with a 2 argument, selects the first
  356.                     item in the history list and replaces the text
  357.                     with that item.
  358.  
  359.                     When called with a 3 argument, selects the last
  360.                     item in the history list and replaces the text
  361.                     with that item.
  362.  
  363.                     Calls the callbacks for XXXXmmmmNNNNccccoooommmmmmmmaaaannnnddddCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk.
  364.  
  365.  
  366.         AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr
  367.           The Command widget has the additional behavior described
  368.           below:
  369.  
  370.  
  371.           MMMMAAAAnnnnyyyy KKKKCCCCaaaannnncccceeeellll:
  372.                     If the parent of the Command is a manager, the
  373.                     event is passed to the parent.
  374.  
  375.           KKKKAAAAccccttttiiiivvvvaaaatttteeee in Text:
  376.                     Calls the Text widget's XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk
  377.                     callbacks.  If the text is empty, this action then
  378.                     returns.  Otherwise, if the history list has
  379.                     XXXXmmmmNNNNhhhhiiiissssttttoooorrrryyyyMMMMaaaaxxxxIIIItttteeeemmmmssss items, it removes the first
  380.                     item in the list.  It adds the text to the history
  381.                     list as the last item, clears the text, and calls
  382.                     the XXXXmmmmNNNNccccoooommmmmmmmaaaannnnddddEEEEnnnntttteeeerrrreeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.
  383.  
  384.           <<<<KKKKeeeeyyyy>>>> in Text:
  385.                     When any change is made to the text edit widget,
  386.                     this action calls the callbacks for
  387.                     XXXXmmmmNNNNccccoooommmmmmmmaaaannnnddddCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk.
  388.  
  389.           <<<<DDDDoooouuuubbbblllleeeeCCCClllliiiicccckkkk>>>> or <<<<KKKKAAAAccccttttiiiivvvvaaaatttteeee>>>> in List:
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 4/30/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmCCCCoooommmmmmmmaaaannnndddd((((3333XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXmmmmCCCCoooommmmmmmmaaaannnndddd((((3333XXXX))))
  401.  
  402.  
  403.  
  404.                     Calls the List widget's XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAAccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
  405.                     callbacks.  If the history list has
  406.                     XXXXmmmmNNNNhhhhiiiissssttttoooorrrryyyyMMMMaaaaxxxxIIIItttteeeemmmmssss items, this action removes the
  407.                     first item in the list.  It adds the selected List
  408.                     item to the history list as the last item, clears
  409.                     the text, and calls the XXXXmmmmNNNNccccoooommmmmmmmaaaannnnddddEEEEnnnntttteeeerrrreeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
  410.                     callbacks.
  411.  
  412.           <<<<FFFFooooccccuuuussssIIIInnnn>>>>:
  413.                     Calls the callbacks for XXXXmmmmNNNNffffooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk.
  414.  
  415.           <<<<MMMMaaaappppWWWWiiiinnnnddddoooowwww>>>>:
  416.                     When a Command that is the child of a DialogShell
  417.                     is mapped, this action calls the callbacks for
  418.                     XXXXmmmmNNNNmmmmaaaappppCCCCaaaallllllllbbbbaaaacccckkkk.
  419.  
  420.           <<<<UUUUnnnnmmmmaaaappppWWWWiiiinnnnddddoooowwww>>>>:
  421.                     When a Command that is the child of a DialogShell
  422.                     is unmapped, this action calls the callbacks for
  423.                     XXXXmmmmNNNNuuuunnnnmmmmaaaappppCCCCaaaallllllllbbbbaaaacccckkkk.
  424.  
  425.  
  426.         VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
  427.           The bindings for virtual keys are vendor specific.  For
  428.           information about bindings for virtual buttons and keys, see
  429.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX)))).
  430.  
  431.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  432.           CCCCoooommmmppppoooossssiiiitttteeee((((3333XXXX)))), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt((((3333XXXX)))), CCCCoooorrrreeee((((3333XXXX)))),
  433.           XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX)))), XXXXmmmmCCCCoooommmmmmmmaaaannnnddddAAAAppppppppeeeennnnddddVVVVaaaalllluuuueeee((((3333XXXX)))),
  434.           XXXXmmmmCCCCoooommmmmmmmaaaannnnddddEEEErrrrrrrroooorrrr((((3333XXXX)))), XXXXmmmmCCCCoooommmmmmmmaaaannnnddddGGGGeeeettttCCCChhhhiiiilllldddd((((3333XXXX)))),
  435.           XXXXmmmmCCCCoooommmmmmmmaaaannnnddddSSSSeeeettttVVVVaaaalllluuuueeee((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeeCCCCoooommmmmmmmaaaannnndddd((((3333XXXX)))), XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX)))),
  436.           and XXXXmmmmSSSSeeeelllleeeeccccttttiiiioooonnnnBBBBooooxxxx((((3333XXXX)))).
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 4/30/98)
  460.  
  461.  
  462.  
  463.